home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 April: Mac OS SDK / Dev.CD Apr 98 SDK1.toast / Development Kits (Disc 1) / QuickDraw 3D / Samples / SampleCode / readme next >
Encoding:
Text File  |  1997-08-14  |  3.0 KB  |  39 lines  |  [TEXT/ttxt]
  1. Sample code readme
  2. ==================
  3.  
  4. The sample code in this folder is designed to help you get to grips with developing with QuickDraw 3D.  If you have comments on the samples (bugs, fixes, requests, etc) please contact Apple's developer technical support (DTS) organization at:
  5.  
  6. devsupport@apple.com
  7.  
  8. You can contact me directly to report problems too, but I'm afraid that I may not be able to answer individual questions (I have a day job :), remember DTS is always there for you.  My email address is nickt@apple.com.
  9.  
  10. Also remember that you can also check out our web page and the QuickDraw 3D mailing list to get information and ask questions.  The web page has details of how to subscribe to the mailing list: to access the QuickDraw 3D website point your web browser at the following URL
  11.  
  12. http://QuickDraw3D.apple.com
  13.  
  14. MAKE SURE that you set enums to int and powerpc alignment or you will get strange crashes when calling QuickDraw 3D routines.
  15.  
  16. NOTE: We recommend that you use the debug version of the QuickDraw 3D library.  If you use the debug version of the library, you must have MacsBug installed, since the debug version uses DebugStr to print errors and warnings out.
  17.  
  18. NOTE: As the release note mentioned a bunch of stuff, particularly the picking stuff was removed from the headers.  The stubs are still in the library, so you can brew your own, by using the pre-1.5.3 headers (the pick stuff will be in from 1.0 onwards).  Whilst we recommend that you remove these old API calls, we also appreciated this may take some time, so if names are missing get them from older versions of the headers.
  19.  
  20. Symantec C/C++ users
  21. ====================
  22.  
  23. We tested with release 5 of Symantec C++ 8.x.  Copy the headers and stub libraries to the appropriate places in your development system.  Projects are supplied for each sample.
  24.  
  25. stub libraries --> ":Sym C++ for Power Mac:Macintosh Libraries:Shared Libraries"
  26. headers --> ":Sym C++ for Power Mac:Macintosh Libraries:QD3D Interfaces"
  27.  
  28. NOTE: In this version of the SDK there is a slight problem with the headers.  You will get warnings to say that the line: 
  29.  
  30. File “QD3D.h”; Line 89; While compiling “3DMF2PICTShell.c”
  31. Warning:   unrecognized pragma
  32.  
  33.  
  34. MetroWerks users
  35. ================
  36.  
  37. We tested with CodeWarrior 11.  If you copy the entire SDK to a hard disk everything will work fine.  We set the projects up with relative pathnames, so if you change the relationship of the folders the development system may not find stuff properly.  To fix this either explicitly point the project pathnames at the new location, or copy the libs and headers to your development folder.
  38.  
  39. NOTE: Metrowerks has shipped with QuickDraw 3D 1.0.6 headers for the past few releases so make sure you replace these with the new 1.5.3 headers (make a backup of the MW old headers first).  Make sure if you move the QuickDraw 3D headers someplace else that you place them in the includes (see the access paths preference panel) before the standard mac includes to ensure you get the correct version, AND that you reset file paths with CW11 to make sure the correct ones get used.